package com.conero.yangsu;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.oas.annotations.EnableOpenApi;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;

/**
 * Swagger 配置
 * 2021年11月25日 星期四
 * [实验性] 错误，版本不支持。
 */
@EnableOpenApi
@Configuration
public class SwaggerConfig {
    //读取application.properties 文件设置的是否开启swagger属性，正式环境一般需要关闭
    @Value(value = "${swagger.enabled}")
    Boolean swaggerEnabled;

    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.OAS_30).apiInfo(apiInfo())
                .enable(swaggerEnabled).select()    // 是否开启swagger
                // 过滤条件，扫描指定路径下的文件
                .apis(RequestHandlerSelectors.basePackage("com.conero.yangsu.controller"))
                //只保留/user/*风格的路径，大家可以调试一下
                // .paths(PathSelectors.ant("/user/*"))
                // 指定路径处理，PathSelectors.any()代表不过滤任何路径
                .paths(PathSelectors.any())
                .build()
                //.pathMapping("/")
                ;
    }
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("Spring Boot集成Springfox Swagger示例")
                .description("楼兰胡杨")
                // 开发者信息
                .contact(new Contact("楼兰胡杨", "https://www.cnblogs.com/east7/", "conero@163.com"))
                .version("1.0.0")
                .build();
    }
}
